home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 12 / picswch6.doc < prev    next >
Encoding:
Text File  |  1985-11-19  |  8.8 KB  |  184 lines
  1. PicSwitch ST Picture Utility
  2. (c)1986 John Brochu for Advanced Software
  3.  
  4. Version: 0.6
  5. Released: June 11, 1986
  6.  
  7. FOR COLOR SYSTEMS ONLY
  8.  
  9. PicSwitch 0.6 is distributed as SHAREWARE.  You are encouraged to freely
  10. distribute the program.
  11.  
  12.  
  13. This version reads the following file formats:
  14.  
  15.      o  DEGAS................................. [.PI1-.PI3]
  16.      o  NeoChrome.................................. [.NEO]
  17.      o  NVision.................. [.SC0-2, .CL0-2, .PG0-2]
  18.      o  Amiga IFF low- & med-rez................... [.IFF]
  19.      o  MacPaint................................... [.MAC]
  20.      o  Mac Startup screen......................... [.MAS]
  21.      o  CIS Vidtex hi-rez RLE...................... [.RLE]
  22.  
  23.  
  24. And writes the following ST file formats:
  25.  
  26.      o  DEGAS
  27.      o  NeoChrome
  28.      o  NeoChrome 'page' (for NVision)
  29.  
  30.  
  31. All pics can be saved in ANY resolution, with automatic conversion to the
  32. selected resolution.  Conversions from a higher rez to a lower rez are
  33. automatically optimized using a color averaging technique for best results.
  34. Conversions from hi-rez allow you the option of saving the picture using the
  35. full palette (best if you may want to restore the pic to its original state at
  36. a later date) or with the minimum possible palette (low-rez conversions would
  37. use 5 colors, med-rez 3).
  38.  
  39. MacPaint files are also allowed a fourth save option.  Compressed save allows
  40. you to 'squeeze' a full 720-line MacPaint document into only 240 high-quality
  41. med-rez lines, thus losing only 15% of the picture.
  42.  
  43. In all cases, you are allowed to 'Preview' the conversion before saving it,
  44. without affecting the original picture.  Monochrome previews will display the
  45. picture in PicSwitch's 'simulated monochrome' mode, but will actually save in
  46. monochrome format for use on the Atari SM124 monitor (or for further use with
  47. PicSwitch!).
  48.  
  49.  
  50. Using the program
  51. -----------------
  52. To load a picture using the GEM file selector, double click on its filename or
  53. single-click and then click OK.  The file will load and display.  (If it is a
  54. monochrome ST or Mac picture, the file will display in med-rez 'simulated
  55. mono'.)  At this point you can press 'Help' for a list of available keyboard
  56. commands.  Following is an explanation of all the commands:
  57.  
  58. For all pics...
  59. o   [Undo] or the right mouse button:  exits the pic and returns you to the
  60.        file selector.
  61. o   [Help]:  displays the command list.
  62. o   [I]:  displays the information screen.
  63. o   [S]:  displays the save dialog.
  64. o   [P]:  dumps a color or monochrome screen to the printer.  To use this
  65.        option, you must have a DEGAS printer driver with a ".PRT" extender
  66.        present in the directory the program is in.  The [Alt] key works
  67.        as in DEGAS, ie.[P] prints a full page, [Alt-P] prints a half-page.
  68.        Pressing [Undo] during a print aborts the dump.
  69. o   [M]:  dumps a monochrome screen or page to the printer.  [Undo] aborts
  70. a printout.  The default printer type is of course Epson/Atari dot
  71. matrix.  Other printers capable of 8-bit graphics can be configured
  72. using a ".PSW" driver described later.
  73.  
  74. For Amiga IFF pics...
  75. o   [1]-[6]:  selects the bit-planes to be displayed.
  76. o   [Space]:  cycles through settings [1]-[6].
  77. o   [R],[G],[B]:  boosts the selected color.
  78. o   [Return]:  restores the default planes and colors.
  79. Low-rez 32-color pics have 5 'planes' or 5 bits of color-register selection.
  80. Keys 1-5 'pull out' one of the planes for display on the ST's 4-plane hardware.
  81. Med-rez 16-color pics have 4 planes.  Keys 1-6 in med-rez therefore need to
  82. pull out 2 planes at a time.  The following table summarizes the planes that
  83. are displayed.  The space bar cycles through each in turn.
  84.      +-----+---------+-----+
  85.      | key |   low   | med |
  86.      +-----+---------+-----+
  87.      |  1  | 1,2,3,4 | 2,3 |
  88.      |  2  | 0,2,3,4 | 1,3 |
  89.      |  3  | 0,1,3,4 | 1,2 |
  90.      |  4  | 0,1,2,4 | 0,3 |
  91.      |  5  | 0,1,2,3 | 0,2 |
  92.      |  6  | ---na-- | 0,1 |
  93.      +-----+---------+-----+
  94. Amiga's hardware also allows 4-bit color resolution, or 16 levels each of red,
  95. green, and blue.  Since the ST only has 3-bit resolution, each IFF RGB color
  96. palette entry is cut in half to bring it into the ST's range.  The R,G,B keys
  97. add one to the IFF value before halving it.  This helps bring out some of the
  98. detail that may be lost if some of the registers convert to the same color.
  99.  
  100. For MacPaint pics...
  101. o   Pressing the left mouse button activates a 'grabber' similar to Neo's.
  102. o   C - Compress the picture vertically.  Note this is also available from
  103.      the Save dialog;  however, this command allows you to scroll the
  104.      picture with the grabber before saving.  Pressing this a second time
  105.      restores the original pic.
  106.  
  107. For NVision pics...
  108. o   Pressing the left mouse button activates the grabber.
  109.  
  110.  
  111. Printer Drivers
  112. ---------------
  113. Printer drivers are loaded automatically when you first run the program.  The
  114. file extenders ".PRT" and ".PSW" are searched for in the current directory
  115. (this allows you to have all PicSwitch-related files in one folder if you
  116. like).  The first file of each type that was written to that directory is
  117. loaded.  A PRT file is necessary to use the screen [P]rint command.  These are
  118. the stand-alone DEGAS printer drivers written by Tom Hudson that are available
  119. on most public boards.  A PSW file is only necessary to use the [M]ono print
  120. command if you do not have an Epson-compatible printer.
  121.  
  122. The mono driver in the current version of PicSwitch only supports 8-pin
  123. graphics and 960 dots per line density.  PSW files are text files containing
  124. the decimal ascii codes necessary for setting up your printer for graphics.
  125. All PSW files must have three command lines separated by a single carriage
  126. return.  Only the ascii characters 0-9, L, l, H, h, <comma>, <space>, and CR/LF
  127. are recognized;  all other characters are ignored.  Each printer code must be
  128. separated by a space or comma delimiter.  A maximum of 32 codes are allowed on
  129. each line.
  130.  
  131. The first line contains the decimal codes for initializing your printer for
  132. graphics.  These codes are sent to the printer only once at the start of a
  133. graphics dump.  The second line is sent before every line of graphics and tells
  134. the printer how many columns of data are to follow.  The third and final line
  135. is sent after the last line is printed and restores the printer to normal
  136. operation.
  137.  
  138. The following is a sample PSW file (EPSON defaults):
  139. 27 51 23
  140. 27 76 L H
  141. 27 50
  142.  
  143. The 1st line: <ESC> "3" 23, tells the Epson to set the line spacing in 216ths
  144. inch increments, to 23/216 of an inch.  You could substitute any line spacing
  145. command you like here.  I found this setting worked very well in getting rid of
  146. the dreaded white lines.  (24/216 or 8/72 is the more 'correct' setting to use
  147. here since the Epson's pin spacing is 1/72 inch.)
  148.  
  149. The 2nd line: <ESC> "L" L H, tells the Epson to print (L+256*H) columns of 960
  150. dots per line graphics.  You need not be concerned with the actual 'L'ow and
  151. 'H'igh values here, PicSwitch will substitute the correct values for L and H
  152. according to how long the actual line of picture data is.  Just make sure you
  153. put the L and H in the correct place for your printer.  Note you MUST use 960
  154. dots per line density.
  155.  
  156. The 3rd line: <ESC> "2", tells the Epson to return to the original 1/6 of an
  157. inch line spacing.  You could also use a 'reset' command here (<ESC> "@" for
  158. the Epson) if you wish.
  159.  
  160. A line feed is sent at the end of each completed printer dump.  If the printer
  161. is not available, the console bell will sound.
  162.  
  163. All printouts done with either [P]rint or [M]onoprint are printed in the
  164. ORIGINAL picture's resolution, not from screen memory.  This allows mono pics
  165. to be printed with no loss of resolution.  MacPaint pics cannot be printed in
  166. compressed mode unless you first save the file in compressed form, reload it,
  167. then print it out with the [P] command.  Remember, the [M] command is for
  168. monochrome prints only, either full-page MacPaint or NVision monochrome, or
  169. mono DEGAS or Neo screens.  The [P] command prints ALL single screen pictures
  170. using a DEGAS driver.  If the picture is a full-page image, the section of the
  171. pic currently displayed is what gets printed.
  172.  
  173. Well, I guess that covers it for this version!  I have tried to include
  174. everyone's suggestions in 0.6, many thanks to everyone who took the time to
  175. write me.  As always, I can be reached on GEnie [JAKOB] and Compuserve
  176. [70376,1235] or you can write me at the address below.  If you have any
  177. comments or ideas, I'd like to hear from you!
  178.  
  179.  
  180. John Brochu
  181. Advanced Software
  182. 21 Northend Street
  183. Peabody, MA  01960